The Navigation Services suite greatly enhances the user experience of opening, saving and selecting documents, while giving your application new capabilities without customizing dialogs. Some of the benefits of adopting Navigation Services APIs for your application include:
- new movable, resizable, Appearance-aware Open & Save dialogs
- easier navigation: list view with disclosure triangles, recent items, favorite items, etc
- built-in access to AppleTalk and AppleShare servers
- built-in file format translation
More information on the features of the new dialogs may be found in the Navigation Services developer note.
How to use Navigation Services
Navigation Services is released as a fat CFM shared library. It can be used to build PowerPC applications as well as 68K applications, using CFM-68K or classic 68K runtime models.
To use Navigation Services in your application:
- #include "Navigation.h"
Then link with:
- PowerPC: Navigation shared library
- CFM-68K: Navigation shared library
- classic 68K: Navigation.o / Navigation.far.o
On 68K systems, replace the OpenTransportLib.68k in your Extensions folder with the one included in this SDK.
To use Navigation Services, make sure that the Navigation shared library is installed in the Extensions folder of your machine.
For sample code, refer to the SimpleText or Sampler application folders found in the SDK.
Limitations and Caveats
This software is provided for the purposes of developing and testing your software. Using this alpha version of Navigation Services involves a degree of risk; it may crash your application, so do not use this software for critical tasks or on machines containing information you cannot afford to lose (especially 68K systems.)
If you wish to add items to the Favorites or Recents list using Sampler, our example application, make sure to set its "isHighLevelEventAware" flag in its 'SIZE' resource. The same goes with your own application that uses the current build of Navigation Services.
